home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / graphics / magps402.zip / USE.DOC < prev   
Text File  |  1996-04-25  |  16KB  |  285 lines
  1. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  2. ▒▒                                                                           ▒▒
  3. ▒▒     PICTOPS (PICture TO PostScript file) power conversion program         ▒▒
  4. ▒▒                     All Rights Reserved                                   ▒▒
  5. ▒▒                Version 4.02 Revision 24/04/96                             ▒▒
  6. ▒▒         Copyright (C) 1995-1996 by TerSoftWare DNP IHEP Russia            ▒▒
  7. ▒▒                     Created by Igor L. Vassiliev                          ▒▒
  8. ▒▒ Author may be reached as:                                                 ▒▒
  9. ▒▒                           E-mail: vasiliev_i@mx.ihep.su                   ▒▒
  10. ▒▒   ╔═══════╗ ╔═══════╗        Fax: (007)(095)-230-2337                     ▒▒
  11. ▒▒   ║       ║ ║                     Department Of Neutrino Physics          ▒▒
  12. ▒▒   ║       ║ ║                     To: Igor L. Vassiliev                   ▒▒
  13. ▒▒   ║       ║ ╚═══════╗       Mail: P.O.Box 142284 Russia                   ▒▒
  14. ▒▒   ╠═══════╜         ║             Moscow region, Protvino                 ▒▒
  15. ▒▒   ║  ┌┐┌─           ║             Lesnoj boulvar 12-74                    ▒▒
  16. ▒▒   ║ ─┼┘└─   ╚═══════╝             To: Igor L. Vassiliev                   ▒▒
  17. ▒▒                                                                           ▒▒
  18. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  19.  
  20.                          *PURPOSE*
  21. To convert image files to compressed PostScript-2 file format.
  22. (PostScript is a trademark of Adobe Systems, Incorporated.)
  23.  
  24.                          *FEATURES*
  25. PICTOPS V4.02 is power conversion program to convert image files to COLOR,
  26. GRAY and biLevel PostScript file format. Analogous programs are unknown.
  27. The following the base of PostScript implementations are used.
  28. I)  Involved PostScript compression.
  29. PICTOPS will compress (PostScript program will decompress) image data
  30. by CCITTFaxEncode, LZWEncode or RunLengthEncode and then by ASCIIHexEncode
  31. or ASCII85Encode filters. Also, it is possible to create BINARY PostScript
  32. file without ASCIIHex or ASCII85 encoders (PostScript file will be not
  33. ASCII-printable in this case). Output from PICTOPS may have much small
  34. size than standard PostScript outs from other programs with simple Level-1.
  35. In most cases, PKZIP or ARJ cannot compress PostScript out from PICTOPS
  36. more than 5-20% !
  37. II) Involved PostScript colour implementations.
  38. Supported simple 5-operand form of the (gray)image and 7-operand form of
  39. colorimage. Also, for index modes, image dictionaries which are
  40. a more general means for specifying parameters to the image operator are used.
  41. The image operator has a 1-operand form in which the operand is an image
  42. dictionary. In case with image dictionary setcolorspace operator will be used
  43. and data into the PostScript file will be presented as color indexes with
  44. color palette.
  45. Image sample in the 'out-PostScript-file' may consists of 1,2,4,8 and 24(RGB)
  46. bits per component. CMYK images will be translated to RGB images.
  47. PostScript image-source data may be provided by string, procedure or filter.
  48.  
  49.                          *NOTE*
  50. If PostScript device HAVE NOT ANY IMPLEMENTATIONS OF LEVEL-2, then the program
  51. automatically will be running as PostScript LEVEL-1 !
  52. For example. If PICTOPS was ran with /zRLE and /c options, and 'in-Image-file'
  53. has color-index palette, then (by descend):
  54. 1) If PostScript program detected RunLengthDecode filter and detected that
  55.    there is setcolorspace operator - will be FAST PS-Run with PostScript
  56.    filter and (color)image with dictionary.
  57. 2) If setcolorspace operator was not detected, but was detected colorimage
  58.    operator and RunLengthDecode filter - will be FAST PS-Run with PostScript
  59.    filter and colorimage.
  60. 3) if RunLengthDecode filter was not detected, but was detected colorimage
  61.    operator - will be PS-Run with no PostScript filter and with colorimage.
  62. 4) if colorimage operator was not detected, but PostScript filter was
  63.    detected - will be FAST PS-Run with PostScript filter and with (gray)image.
  64. 5) if PostScript filter and colorimage operator was not detected - will be
  65.    PS-run with no PostScript filter and with (gray)image.
  66. Another words, PostScript run will be work in the any cases !
  67.  
  68.                       *REQUIREMENTS*
  69. Program requires an IBM PC/AT/fully compatible computer, MS-DOS 3.30 or greater
  70. and from 180 to 450 Kb of free conventional memory.
  71. Any Intel processor from i86(88).But 66MHz and better is recommended for speed.
  72. Program will running without any XMS/EMS (If presented so will be ignored).
  73.  
  74.                          *USAGE*
  75.  pictops [options] [d:path]in-Image-file [[d:path][out-PostScript-file.ps]]
  76.  
  77.                          *IMPORT*
  78.  BMP - MS-Windows 3.1 Bitmap Format. BMP is the native bitmap file
  79.        format of the Microsoft Windows environment.
  80.          + 1,4,8 and 24 bits/pixel
  81.          + BI_RGB,BI_RLE4 and BI_RLE8.
  82.  GIF - Graphics Interchange Format. GIF is the Copyright property of
  83.        CompuServe Incorporated.
  84.          + 1,2,3,4,5,6,7 and 8 bits/pixel
  85.          + GIF87a and GIF89a modifications
  86.  ICO - MS-Windows Icon Format.
  87.          + 1,4 and 8 bits/pixel.
  88.  PCX - ZSoft Paint.
  89.          + 1,4,8 and 24 bits/pixel
  90.  PBM - Portable Bitmap. Extended Portable Bitmap Utilities (PBMPLUS).
  91.          + 1 bit/pixel
  92.          + binary subtype only
  93.  PGM - Portable Greymap.
  94.          + 8 bits/pixel
  95.          + binary subtype only
  96.  PPM - Portable Pixmap file format.
  97.          + 24 bits/pixel
  98.          + binary subtype only
  99.  RLE - The same that compressed BMP.
  100.          + 4 and 8 bits/pixel
  101.          + BI_RLE4 and BI_RLE8.
  102.  TGA - Truevision (Targa) File Format. TGA is the native file format
  103.        of the Truevision Incorporated.
  104.          + 8,15,16,24,32 bits/pixel
  105.          + 1,2,3,9,10,11 subtype images
  106.  TIF - Tag Image File Format. TIFF is the native file format
  107.        of the Aldus Developers Desk.
  108.          + 'II' and 'MM' byte order
  109.          + BytesPerStrip (Any length. May be more than 64K)
  110.          + RowsPerStrip (Any length. Unused)
  111.          + 1,2,4,8,24,32 bits/pixel
  112.          + Compression
  113.            + No compression (1)
  114.            + CCITT Group 3 1D, Modified Huffman (2)
  115.            - Group 3 Fax (3)
  116.            - Group 4 Fax (4)
  117.            + LZW (5)
  118.              + Horizontal differencing (Predictor)
  119.                + For any bits number supported
  120.            - JPEG (6)
  121.            + PackBits (32773)
  122.          + PhotometricInterpretation
  123.            + biLevel and GrayScale (0,1)
  124.            + RGB and RGBA (2)
  125.            + Palette color (3)
  126.            - Transparency mask (4)
  127.            + CMYK (5)
  128.              + 12 inks are max
  129.            - YCbCr (6)
  130.            - CIELab (8)
  131.  
  132.                           *NOTE*
  133. Import file may have any extention. File type will be detected automatically.
  134.  
  135.                          *EXPORT*
  136. Color, Gray or biLevel compressed or not 'out-PostScript-file' within Level-1
  137. and Level-2, if have no error messages received.
  138.  
  139.                           *NOTE*
  140. If name 'out-PostScript-file' is not specified and /sXXX option is absent,
  141. then the file type will be as PostScript with name [d:path]in-Image-file.ps
  142.  
  143.                          *OPTIONS*
  144. The all command options must be preceded either '-' or '/' character.
  145. The options are described as follows:
  146. /zFAX  - Import image data will be encoded at first by means of
  147.          PostScript FAX (Modified Huffman compression. Group 3,1-D) filter and
  148.          then through PostScript ASCII85Encode filter, which will be extend
  149.          binary data to ASCII printable chars as 4:5
  150.          *NOTE* In most cases, effect from compression will be for mono
  151.                 image only !
  152.          *NOTE* If width of image is too large, PostScript error message
  153.                 may be received: /rangecheck in --.filter_CCITTFaxDecode--
  154. /zLZW  - Import image data will be encoded at first by means of
  155.          PostScript LZW (Lempel-Ziv-Welch) filter and then
  156.          through PostScript ASCII85Encode filter, which will be extend
  157.          binary data to ASCII printable chars as 4:5
  158. /zRLE  - Import image data will be encoded at first by means of
  159.          PostScript RLE (Run-Length-Encode) filter and then
  160.          through PostScript ASCII85Encode filter, which will be extend
  161.          binary data to ASCII printable chars as 4:5
  162. /zWOC  - Without PostScript compression (by default)
  163.          Import image data will be encoded through ASCIIHexEncode
  164.          filter e.g. each binary byte will be presented by two ASCII
  165.          printable hex-digits. Extention is as 1:2
  166. /sPS   - Set output as PostScript (by default)
  167. /sEPS  - Set output as Encapsulated PostScript
  168. /sEPSI - Set output as Encapsulated PostScript Interchange (EPS with preview)
  169.          *NOTE* Option /sEPSI is not available in version 4.xx
  170. /L2    - To force PostScript Level-2 only. Program will NOT detect in
  171.          PostScript device whether there is Level-2 or not.
  172. /g     - To force grayscale PostScript output (by default)
  173. /c     - To force color PostScript output
  174. /i     - Background inversion (if possible)
  175.          *NOTE* If Image type is:
  176.            biLevel - directly bits inversion (Background inverse)
  177.            Gray    - directly bits inversion (Negative)
  178.            Index   - Inversion of the first Palette-Index (Background inverse)
  179.            RGB /g  - Translate to GrayScale and bits inversion (Negative)
  180.            RGB /c  - Not applicable
  181. /b     - To force binary PostScript out.
  182.          (ASCIIHexEncode or ASCII85Encode filters will be not implemented)
  183.          *NOTE* Output PostScript file will be NOT ASCII printable !
  184. /AD    - To force PostScript out to scale to real image size (by default)
  185.          *NOTE* If image size exceed sizes A4-Europe either by width or by
  186.                 height or both, A4-Europe format will be done automatically.
  187. /A4E   - To force PostScript out to scale to A4 Europe standard 210mm x 279mm.
  188.          (Left and Right white margin by 14 mm. Up and Bottom by 28 mm)
  189.          *NOTE* Available with /sPS option only !
  190. /A4U   - To force PostScript out to scale to A4 USA standard 8.5" x 11".
  191.          (Left and Right white margin by 0.67". Up and Bottom by 0.75")
  192.          *NOTE* Available with /sPS option only !
  193. /R     - PostScript out will be 90-rotated (Landscape). Default is Portrait.
  194.          *NOTE* Available with /sPS option only !
  195.          *NOTE* If used together with /A4X options, so the rotate will be
  196.                 done at first then scale.
  197. /o     - Overwrite PostScript output if it exists without prompt.
  198. /t     - Turn on time of PostScript encoding
  199. /cr    - Turn on compress ratio
  200. /wo    - Turn off warning messages
  201. /n=x   - Ico-Image number [x=1:7]
  202. /h,?   - this Help
  203.  
  204.                          *USAGE EXAMPLE*
  205. 1) C:\>pictops sample
  206.    Image file 'sample' will be translated into the grayscale PostScript
  207.    file 'sample.ps' with no PostScript compression, picture is centered,
  208.    size default.
  209.    (Equivalent is: C:\>pictops /zWOC /sPS /AD /g sample sample.ps)
  210. 2) C:\>pictops /zRLE /R /A4U /c /b c:\tmp1\sample *
  211.    Image file 'c:\tmp1\sample' will be translated into the binary, color
  212.    PostScript file 'c:\sample.ps' with PostScript RLE compression,
  213.    picture 90-rotated and scaled to A4 USA standard.
  214. 3) C:\>pictops /L2 /sEPS c:\tmp1\sample.pcx
  215.    Image file 'c:\tmp1\sample.pcx' will be translated into the grayscale
  216.    Encapsulated PostScript file 'c:\tmp1\sample.eps' without PostScript
  217.    compression, with Level-2 codes only, picture is centered, size default.
  218.  
  219.                     *RECOMENDATIONS TO USE*
  220. Although PICTOPS have enough big collection of warning-messages about
  221. suspicion in corrupted image files, nevertheless it is recomended before to run
  222. output file on the PostScript printer, BE SURE that your PostScript file has
  223. valid format. For example, it may be done by GS.EXE or by any other viewer.
  224. (Recommended to use GS386.EXE instead GS.EXE, because GS.EXE sometimes invalid
  225. displayed large (more than 3000x3000) RGB images)
  226.  
  227.                          *NOTE*
  228. If 'in-Image-file' has Color-Index-Palette consisting of the N-entrances
  229. and during Color-PS-Run will occure byte which has meaning more than N, then
  230. PostScript error message may be received: /rangecheck in --getinterval--
  231. or: /rangecheck in --get--. PICTOPS not give error message, because
  232. I have no desire to watch such cases !
  233.  
  234.                          *NOTE*
  235. Ghostscript Version 54.0 Rev 2.6.1. 05/28/93 (may be and other versions)
  236. has some errors in PostScript Filters. Some detected errors:
  237. ╔═══════════════╦════════╦════════════════════════════════════════════════════╗
  238. ║  Filter name  ║ Errors ║             Description                            ║
  239. ╠═══════════════╬════════╬════════════════════════════════════════════════════╣
  240. ║               ║        ║ Sometimes it don't read terminator sign '>' after  ║
  241. ║ASCIIHexDecode ║  YES   ║ data. Without '>' always is okay.                  ║
  242. ║               ║        ║ (PICTOPS don't write this sign)                    ║
  243. ╟───────────────╫────────╫────────────────────────────────────────────────────╢
  244. ║ASCII85Decode  ║   NO   ║ No errors detected                                 ║
  245. ╟───────────────╫────────╫────────────────────────────────────────────────────╢
  246. ║CCITTFaxDecode ║   NO   ║ No errors detected (Group 3,1-D)                   ║
  247. ╟───────────────╫────────╫────────────────────────────────────────────────────╢
  248. ║               ║        ║ Sometimes, data from file are not reading to end   ║
  249. ║LZWDecode      ║  YES   ║ calling error: /undefined in ABC...                ║
  250. ║               ║        ║ Where ABC... are data from PS-file. More often this║
  251. ║               ║        ║ take place upon monotonous and continuous images.  ║
  252. ╟───────────────╫────────╫────────────────────────────────────────────────────╢
  253. ║RunLengthDecode║   NO   ║ No errors detected                                 ║
  254. ╚═══════════════╩════════╩════════════════════════════════════════════════════╝
  255. Your action in error cases:
  256. 1) EITHER
  257.    Remove comment (percent sign) in the line:
  258.    %/Check_Filter false def
  259.    In this case PostScript-run will be with no Filters.
  260.    (File must be done without /b and /L2 options, of course !)
  261.    OR
  262. 2) Do make run PICTOPS with other filter.
  263.  
  264.                          *REGISTRATION*
  265. PICTOPS is inexpensive shareware. If you find that PICTOPS is useful and
  266. continue using it after a trial period of 20 days, you are encouraged to pay
  267. a small registration fee. When you register, you will receive the last version
  268. of PICTOPS and your registration number. Registration entitles you continue
  269. using the current version and all future versions. The registration number
  270. will remove any limitation functions in the unregistered version of the
  271. current and the future releases.
  272. To register your copy of PICTOPS, please, send me your request to:
  273. E-mail: vasiliev_i@mx.ihep.su
  274. Unregistered version has one limitation - the maximum resolution of an
  275. 'in-Image-file' is 640x480. The limitation will be removed in the registered
  276. version.
  277.  
  278. ╔═════════════════════════════════════════════════════════════════════════════╗
  279. ║                          *WARNING*                                          ║
  280. ║ YOU ARE USING PICTOPS AT YOUR OWN RISK ! THE AUTHOR (Igor L. Vassiliev)     ║
  281. ║ IS NOT RESPONSIBLE FOR ANY DAMAGE CAUSED BY THE USE OF PICTOPS OR BY THE    ║
  282. ║ INABILITY TO USE PICTOPS. IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T   ║
  283. ║ ACCEPT THIS, THEN DO NOT USE PICTOPS !                                      ║
  284. ╚═════════════════════════════════════════════════════════════════════════════╝
  285.